Creating a SLC-503/4/5 Custom Data Group
Data groups for an SLC-503/4/5 controller (CIP_Protocol="PCCC_SLC") must be
defined on a case-by-case basis.
You must create data groups that satisfy the following requirements:
- They must map to data items (that is, element, subelement, bit, and/or other component) that exist on associated field devices.
- They must structure data for optimized use in a CygNet SCADA system. For example, group data items to be polled frequently with other such data items.
An SLC data group enables you to access a file and its constituent elements. It requires that each XML data group element is mapped to a data file type and address component (that is, element, subelement, bit, and/or other component). Define data groups that map to address components and represent only those data items on an associated Allen-Bradley device that you want to include in your CygNet SCADA system. Addresses should be supplied by a PLC programmer or collected from the PLC program.
Your device template file provides a high degree of flexibility in defining SLC data groups. In a data group element, the elemAddr attribute enables you to specify the components needed to access virtually any data item on an associated SLC-503/4/5 controller. The syntax of the elemAddr attribute value follows the SLC standard, including the various Allen-Bradley SLC-503/4/5 delimiters.
For more information, see the following subsections:
- To Create a Custom Data Group for SLC
- File Type Values
- Output Data File and Input Data File (O0: and I1:) Syntax
- Status File (S2:) Syntax
- Bit Data File (B3:) Syntax
- Timer Data File (T4:) Syntax
- Counter Data File Elements (C5:) Syntax
- Control Data File (R6:) Syntax
- Integer Data File (N7:) Syntax
- Float Data File (F8:) Syntax
- ASCII Data File Syntax
- String Data File Syntax
For more information about SLCs, see the Rockwell Automation document SLC 500 Instruction Set Reference Manual (1747-rm001_-en-p.pdf).
To Create a Custom Data Group for SLC
- Using a text editor of your choice (but not Notepad), open a new or existing device template file where
CIP_Protocol="PCCC_SLC"is defined. - Define a data group element, including a data group name and description.
- Define a dgElements element.
- Define data group elements to meet your needs.
- Each must be uniquely named.
- Each must map to a data item on the associated field device by correctly defining an elemAddr and type attribute.
- Each must use the correct Allen-Bradley file numbers and types as well as the correct syntax. See syntax sections below.
- Save your edits.
- When you are done editing the template, use the CygNet Device Template Manager utility (DtfMgr.exe) to check your work, then load the template to the applicable Device Definition Service (DDS), and test it by reading and/or writing values.
Note: The requests for non-contiguous elements are optimized to perform the fewest number of transactions for the device.
Example
 Click here to see an example of the element
<DGData niceName="Sample File Data"> <dgElements> <float1 elemAddr="F8:0" type="r4"/> <float2 elemAddr="F8:1" type="r4"/> <float3 elemAddr="F8:2" type="r4"/> <float4 elemAddr="F8:3" type="r4"/> <CntrPre elemAddr="C5:0.PRE" type="ui2"/> <CntrACC elemAddr="C5:0.ACC" type="ui2"/> <CntrDN elemAddr="C5:0/DN" type="boolean"/> <Int1 elemAddr="N7:0" type="ui2"/> <Int2 elemAddr="N7:1" type="ui2"/> <Int3 elemAddr="N7:2" type="ui2"/> </dgElements> </DGData> |
File Type Values
The following table provides addressing values to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| File Type # | Abbrev. | Name | Notes |
|---|---|---|---|
|
0 |
O |
Output |
This file stores the state of the output terminals for the controller. |
|
1 |
I |
Input |
This file stores the status of the input terminals for the controller. |
|
2 |
S |
Status |
This file stores controller operation information. This file is useful for troubleshooting controller and program operation. |
|
3 |
B |
Binary, Bit |
This file is used for internal relay logic storage. |
|
4 |
T |
Timer |
This file stores the timer accumulator and preset values and status bits. |
|
5 |
C |
Counter |
This file stores the counter accumulator and preset values and the status bits. |
|
6 |
R |
Control |
This file stores the length, pointer position, and status bits for specific instructions such as shift registers and sequencers. |
|
7 |
N |
Integer |
This file is used to store numeric values or bit information. |
|
8 |
F |
Float |
This file stores single precision non-extended 32-bit numbers. |
|
- |
A |
ASCII |
This file stores 2 byte ASCII values. Can be file type 9 - 255. |
|
- |
ST |
String |
This file stores 82 byte string values. Can be file type 9 - 255. |
|
9 - 255 |
N/A |
N/A |
Can be any file type except I or O. |
Output Data File and Input Data File (O0: and I1:) Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
O:e.s/b I:e.s/b |
O |
Output |
|
I |
Input |
|
|
: |
Element delimiter |
|
|
e |
Slot number (decimal) |
|
|
. |
Word delimiter |
|
|
s |
Word number |
|
|
/ |
Bit delimiter |
|
|
b |
Terminal number |
|
|
O:3/15 O:5/0 O:10/11 I:7/8 I:2.1/3 O:5 O:5.1 I:8 |
Output 15, slot 3 Output 0, slot 5 Output 11, slot 10 Input 8, slot 7 Input 3, slot 2, word 1 Output word 0, slot 5 Output word 1, slot 5 Input word 0, slot 8 |
|
Status File (S2:) Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
S:e/b |
S |
Status file |
|
: |
Element delimiter |
|
|
e |
Element number |
|
|
/ |
Bit delimiter |
|
|
b |
Bit number |
|
|
S:1/15 S:3 |
Element 1, bit 15 Element 3 |
|
Bit Data File (B3:) Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
Bf:e/b Bf/b |
B |
Bit file |
|
f |
File number |
|
|
: |
Element delimiter |
|
|
e |
Element number |
|
|
/ |
Bit delimiter |
|
|
b |
Bit number |
|
|
B3:3/14 B3:252/00 B3:9 B3/62 B3/4032 |
Bit 14, element 3 Bit 0, element 252 Element 9 Bit 62 Bit 4032 |
|
Note: If a user is sending individual bits via a UIS command, not all bits are required to be defined as data group elements. If a user is sending individual bits via the data group editor, all bits should be defined as data group elements. Sending via the data group editor sends complete bytes and any bits not defined as data group elements are set to 0.
Timer Data File (T4:) Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
Tf:e.s/b |
T |
Timer file |
|
f |
File number |
|
|
: |
Element delimiter |
|
|
e |
Element number |
|
|
. |
Word delimiter |
|
|
s |
Word number |
|
|
/ |
Bit delimiter |
|
|
b |
Bit number |
|
|
T4:0/15 or T4:0/EN T4:0/14 or T4:0/TT T4:0/13 or T4:0/DN T4:0.1 or T4:0.PRE T4:0.2 or T4:0.ACC T4:0.1/0 or T4:0.PRE/0 T4:0.2/0 or T4:0.ACC/0 |
Enable bit Timer timing bit Done bit Preset value of the timer Accumulated value of the timer Bit 0 of the preset value Bit 0 of the accumulated value |
|
Counter Data File Elements (C5:) Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
Cf:e.s/b |
C |
Counter file |
|
f |
File number |
|
|
: |
Element delimiter |
|
|
e |
Element number |
|
|
. |
Word delimiter |
|
|
s |
Word element |
|
|
/ |
Bit delimiter |
|
|
b |
Bit number |
|
|
C5:0/15 or C5:0/CU C5:0/14 or C5:0/CD C5:0/13 or C5:0/DN C5:0/12 or C5:0/OV C5:0/11 or C5:0/UN C5:0/10 or C5:0/UA C5:0.1 or C5:0.PRE C5:0.2 or C5:0.ACC C5:0.1/0 or C5:0.PRE/0 C5:0.2/0 or C5:0.ACC/0 |
Count up enable bit Count down enable bit Done bit Overflow bit Underflow bit Update accum. bit (use with HSC in fixed controller only) Preset value of the counter Accumulated value of the counter Bit 0 of the preset value Bit 0 of the accumulated value |
|
Control Data File (R6:) Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
Rf:e Rf:e.s/b |
R |
Control file |
|
f |
File number |
|
|
: |
Element delimiter |
|
|
e |
Element number |
|
|
. |
Word delimiter |
|
|
s |
Word element |
|
|
/ |
Bit delimiter |
|
|
b |
Bit number |
|
|
R6:2 R6:2/15 or R6:2/EN R6:2/14 or R6:2/EU R6:2/13 or R6:2/DN R6:2/12 or R6:2/EM R6:2/11 or R6:2/ER R6:2/10 or R6:2/UL R6:2/9 or R6:2/IN R6:2/8 or R6:2/FD R6:2.1 or R6:2.LEN R6:2.2 or R6:2.POS R6:2.1/0 R6:2.2/0 |
Element 2, control file 6 Enable bit Unload Enable bit Done bit Stack Empty bit Error bit Unload bit Inhibit bit Found bit Length value Position value Bit 0 of length value Bit 0 of position value |
|
Integer Data File (N7:) Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
Nf:e/b |
N |
Integer file |
|
f |
File number |
|
|
: |
Element delimiter |
|
|
e |
Element number |
|
|
/ |
Bit delimiter |
|
|
b |
Bit number |
|
|
N7:2 N7:2/8 N10:36 |
Element 2, integer file 7 Bit 8 in element 2, integer file 7 Element 36, integer file 10 |
|
Float Data File (F8:) Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
Ff:e |
F |
Float file |
|
f |
File number |
|
|
: |
Element delimiter |
|
|
e |
Element number |
|
|
F8:2 |
Element 2, float file 8 |
|
ASCII Data File Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
Af:e |
A |
ASCII file |
|
f |
File number |
|
|
: |
Element delimiter |
|
|
e |
Element number |
|
|
F9:2 |
Element 2, ASCII file 9 |
|
String Data File Syntax
The following table provides addressing formats and examples to be used when defining CygNet SCADA data groups that are mapped to SLC data files.
| Format | Parts | Description |
|---|---|---|
|
STf:e |
ST |
String file |
|
f |
File number |
|
|
: |
Element delimiter |
|
|
e |
Element number |
|
|
F9:2 |
Element 2, string file 9 |
|
